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I.  INTRODUCTION 


There  is  a  current  desire  by  Korean  students  at  the  Naval  Postgraduate 
School  (NPS)  for  using  available  computer  systems  for  editing  and  printing  the 
''orean  character  set  (Hangul)  for  official  reports  and  correspondence. 
Handwritten  texts  are  not  acceptable  alternatives.  There  is  an  additional  need  to 
retrofit  high  performance  western-produced  computers  for  use  by  Koreans.  This 
study  attempts  to  attack  both  problems  through  the  development  of  a  Korean 
word  processor  on  a  U.S.  computer,  the  Silicon  Graphics.  Inc.  IRIS  workstation, 
and  an  output  capability  on  a  U.S.  produced  laser  printer,  the  QMS-1200. 

A.  REQUIREMENTS  OF  KOREAN  WORD  PROCESSOR 

The  development  of  a  non-Roman  word  processor  is  an  important  research 
effort,  because  the  currently  developed  Korean.  Japanese  and  Chinese  word 
processors  are  not  convenient  for  general  use  due  to  the  many  different 
combinations  of  fundamental  characters  i.e..  top.  side,  and  bottom  combinations. 
Until  now,  most  of  the  Korean  students  of  the  NPS  have  experienced  difficulty 
when  sending  official  documents  to  Korean  government  agencies.  The  Korean 
word  processor  we  have  developed  required  the  examination  of  three  major 
problems  : 
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-  How  to  develop  a  Korean  font  for  printing  on  a  graphics  Laser  printer. 

-  How  to  use  the  Korean  font  for  word  processing. 

-  How  to  use  the  Korean  font  on  an  interactive,  western  produced  graphics 
system. 

B.  CHARACTERISTICS  OF  KOREAN  (HANOI  L) 

The  Korean  written  language  is  called  Hangul.  It  is  a  phonetic  system,  in  the 
sense  that  letters  represent  sound.  The  Hangul  characters  are  written  by  syllabic 
groupings  into  square  clusters. 

Hangul  is  the  only  script  known  to  have  been  designed  by  a  committee.  It  was 
invented  in  1443  by  a  group  of  scholars  under  King  Sejong(  1419-1450)  in  response 
to  an  explicit  royal  directive  to  create  a  native  alphabet  from  scratch.  To 
harmonize  with  the  square  shape  of  Chinese  character-  the  Hangul  are  designed 
to  be  grouped  into  square  clusters  of  two.  three,  or  occasionally  four  fundamental 
characters.  Each  cluster  represents  one  spoken  syllable  of  the  language.  Figure 
1.1  shows  the  basic  Korean  characters.  There  are  14  fundamental  consonants.  5 
combined  consonants.  10  fundamental  vowels,  and  4  combined  vowels  [Ref.  lj. 

The  composite  Korean  letter  may  consist  of  the  first  sound  and  final  sound, 
or  first  sound,  second  sound,  and  final  sound.  Figure  1.2  shows  the  position  of 
each  consonant  and  vowel  in  the  composite  Korean  letter.  That  Figure  also  shows 
the  possible  characters  for  each  position.  The  Korean  letter  contains  the  11 
compound  sound  consonants  and  7  compound  sound  vowels.  The  position  of  each 
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character  into  a  composite  Korean  letter  called  "  Mohaseuki  ".  is  determined  by  a 
small  set  of  rules.  These  rules  are  shown  in  Figure  1.2.  The  Korean  composite 
letter  has  two  three  fundamental  structure  forms,  i.e..  ClYl,  C1Y2.  and 
C1VTV2.  More  complicated  letters  are  produced  by  the  sequential  addition  of  C 
and  Y.  such  as  C1Y1C2.  C1Y2C2.  and  C1Y1Y2C2.  The  number  of  all  the 
characters  produced  exceeds  24.000.  This  quantity  of  characters  makes  the 
automatic  recognition  of  Korean  characters  difficult  [Ref.  2]. 

The  clustering  feature  of  Korean  creates  p-  blems  for  the  Korean  typewriters 
because  it  requires  the  letters  to  assume  different  shapes  and  positions  depending 
on  the  surrounding  context.  Figure  1.3  shows  the  typing  sequence  of  the  eight- 
ietter  word  "Han-gug-oe."  meaning  "Korean  language."  The  fourth  and  sixth 
characters  are  the  same  but  one  of  them  is  written  at  the  top  of  the  syllable 
cluster  while  the  other  ends  up  at  the  bottom.  Figure  1.3  shows  the  actual 
composite  text  required.  The  graphic  forms  shown  in  square  boxes  are 
superimposed  on  each  other  to  build  the  syllabic  clusters.  Typing  each  new  letter 
necessitates  revising  the  form  and  placement  of  letters  that  were  previously  typed, 
an  action  impossible  for  a  mechanical  typewriter  but  easy  for  a  computer 
display. [Ref.  2] 
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C.  DESIRABLE  SYSTEM  CHARACTERISTICS 


1.  System  Must  be  Quick  and  Efficient 

The  Korean  word  processor  we  have  developed  is  heavily  goal- 
orientated;  that  is,  the  author  is  more  interested  in  the  finished  product  than  he 
is  in  the  generation  process.  However,  for  the  user,  the  process  of  creating 
Korean  documents  can  be  as  important,  or  even  more  important,  than  the 
finished  typing  documents.  Therefore,  this  system  must  be  able  to  create  and  edit 
the  Korean  documents  quickly  and  efficiently  or  tin  system  will  not  be 
used. [Ref.  3] 

2.  System  Must  be  Intuitive 

The  system  must  have  a  natural  intuitive  approach  for  typing  Hangul 
letters.  The  importance  of  this  cannot  be  over  estimated;  no  matter  how  efficient 
the  system  ;  at  producing  Korean  documents,  if  the  user  feels  uncomfortable  in 
the  Hangul  word  processor  he  will  go  elsewhere. 

3.  System  Must  Be  Convenient 

The  system  must  offer  the  user  greater  convenience  than  is  currently 
offered  by  handwriting  or  typewriting.  Human  beings  tend  to  ignore  systems  that 
may  be  of  great  advantage  to  them  simply  because  they  are  slightly  inconvenient 
to  use. 


10 


4.  System  Must  Accommodate  Unskilled  Users 

The  user  generally  will  have  little  expertise  typing  Hangul  characters. 
This  is  understandable  as  the  author  who  requires  the  typing  or  editing  of  a 
Korean  file  is  only  using  the  system  as  a  tool.  Therefore  a  Hangul  word  processor 
system  must  be  able  to  be  used  by  the  untrained,  inexperienced  and  even 
disinterested. 

5.  System  Must  Produce  a  High  Quality  Product 

The  user's  work  generally  can  be  classed  as  esoteric  and  thus  its  quality 
cannot  be  quantified.  The  printed  paper  must  be  of  good  quality  and  the  Korean 
characters  produced  must  be  crisp,  clear  and  in  a  well-defined  font.  Therefore  this 
system  must  be  capable  of  outputing  to  a  quality  graphics  printer,  ideally  a  laser 
printer  or  to  a  good  quality  dot  matrix  printer.  The  laser  printer  is  the  preferred 
output  device. 

6.  Ease  of  Modification 

Documents  in  Korean  are  subject  to  frequent  change  for  many 
reasons,  i.e..  missing  words,  mistyping  or  revision  to  their  parts.  Handwriting  or 
typing  do  not  always  allow  corrections  without  some  lessening  of  the  output 
quality.  Therefore,  this  word  processor  system  must  be  capable  of  modifying  the 
contents  of  documents  at  any  time  after  the  original  typing  process. 
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Ease  of  Reproduction 


The  documents  may  need  to  be  reproduced  many  times,  depending  on  the 
requirements.  Typewriten  works  usually  are  not  reproduced  with  the  original 
quality.  Hence  this  system  must  be  able  to  store  and  hence,  reproduce  the  Korean 
documents. 
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II.  PROBLEMS  IN  EDITING  KOREAN 


A.  BACKGROUND  DESCRIPTION 

The  group  of  Korean  students  at  NPS  is  the  largest  group  in  the  international 
community  except  for  US  students.  There  have  been  an  average  of  65  Korean 
students  for  the  past  4  years. 

These  students  have  to  send  grades  and  quarterly  report  to  each  service 
headquarters  at  the  end  of  each  quarter.  To  do  this,  they  have  to  write  or  type 
Korean.  Most  of  the  Korean  students  have  had  the  experience  of  having  problems 
editing  Korean  documents.  No  Korean  typewriters  or  word  processors  are 
available  at  NPS. 

B.  HANDWRITING 

Handwriting  is  probably  the  most  common  method  to  produce  Korean 
documents  both  in  the  official  and  private  environments.  Most  of  the  Korean 
students  at  NPS  have  had  this  type  of  experience  in  editing  Korean. 

The  advantage  of  handwriting  is  that  is  very  convenient  and  no  significant 
cost  is  involved  in  setting  up  the  system.  This  system  is  completely  convenient  to 
the  author,  since  it  requires  no  special  equipment  and  can  be  any  place  at  any 
time.  The  user  can  also  select  the  size  of  papers  to  produce  the  appropriate 
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documents.  The  main  disadvantage  with  this  method  is  that  the  quality  i? 
dependent  on  the  handwriter. 


TABLE  2.1  -  SUMMARY 
HANDWRITING 

Characteristic 

Achievement  of  Goal 

Quick  and  Efficient 

Might  be  only  quick 

Intuitive 

No 

Convenient 

Very 

Accommodate  Unskilled  Users 

Yes 

Quality  Product 

User  dependent  -  quality 
not  guaranteed 

Ease  of  Modification 

Complete  rewrite  required 

Ease  of  Reproduction 

Complete  rewrite  required 

C.  USAGE  OF  THE  TYPEWRITER 

The  Korean  typewriter  is  very  similar  to  the  Roman  character  typewriter. 
The  main  difference  is  the  positioning  of  elemental  characters  in  each  letter.  The 
Roman  typewriter  has  only  one  combination  of  letters,  side  by  side.  The  Korean 
typewriter  has  three  different  combinations  such  as  side  by  side,  top  by  bottom. 
and  top  by  side  by  bottom  (See  Figure  1.2). 

There  are  two  main  advantages  to  the  typewriter  over  handwriting.  They 
are  convenience  and  no  significant  skill  of  usage.  It  is  a  portable  system.  Korean 
documents  can  be  produced  on  a  typewriter  at  any  reasonable  time  and  place. 
Most  Korean  people  are  familiar  with  this  system,  as  it  is  common  in  Korea. 
There  are  two  disadvantages.  The  first  is  the  difficulty  in  correcting  mistakes. 
The  second  is  poor  reproducability  of  the  product. 
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TABLE  2.2  -  SUMMARY 


USAGE  OF  THE  TYPEWRITER 


Characteristic 

Achievement  of  Goal 

Quick  and  Efficient 

Maybe 

Intuitive 

Yes 

Convenient 

Yes 

Accommodate  Unskilled  Users 

Training  desired 

Quality  Product 

Good 

Ease  of  Modification 

Retype  required 

Ease  of  Reproduction 

Complete  retype  required 
or  Photocopying 

III.  WORD  PROCESSOR  DEVELOPMENT  TECHNOLOGY 


A.  KOREAN  FONT  DEVELOPMENT 

The  Korean  characters  are  usually  divided  into  fundamental,  combination, 
compound  consonants  and  vowels,  "'he  principles  for  developing  a  Korean  font 
(character  pattern)  for  a  dot  matrix  printer  and  graphics  display  are  similar  to 
other  fonts. 

1.  Font  for  the  Graphics  Screen 

Most  western  computer  systems  use  the  ASCII  code,  and  a  standard 
keyboard.  When  a  key  is  hit  on  that  keyboard,  that  key  is  translated  into  some 
display  corresponding  to  that  character.  One  type  of  display  frequently  seen  is  a 
matrix  of  dots  layed  out  in  a  pattern  [Ref.  4:  pp.  39-49]. 

The  Silicon  Graphics,  Inc.  IRIS-2400  has  such  a  capability.  The  dot 
matrix  definition  of  the  IRIS’s  standard  Roman  characters  are  7x9  bitmaps  (7 
dots  long  by  9  dots  high).  The  development  of  a  Korean  font  requires  larger 
bitmaps.  The  Hangul  letters  of  our  system  are  designed  to  be  20  bits  by  21  bits 
for  the  composite  letter.  Figure  3.1  shows  the  position  and  size  of  each  type  of 
composite  letter.  Figure  3.2  shows  the  sample  Hangul  letter  that  means  "box"  in 
English. 
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The  first  sound  characters  are  located  in  the  top  left  part  of  the  Hangul 
composite  letter.  These  were  designed  as  10x8  bitmaps,  with  2  bits  of  X-ofisct 
and  11  bits  of  Y-offset.  The  skip  width  of  each  character  is  12  bits.  The  second 
sound  characters  are  divided  into  two  different  types,  i.e.,  the  type  1  characters 
are  located  at  the  right  side  of  the  first  sound  and  the  type  2  characters  are 
located  at  the  bottom  of  the  first  sound  as  shown  in  Figure  3.1.  The  second 
sound  characters  are  also  divided  into  two  different  character  sizes  and  positions 
depending  on  the  type  of  character.  Figure  1.2  shows  two  type  of  vowels,  type  1 
as  Vl  and  type  2  as  V2.  Both  types  of  vowel  (second  sound)  have  their  own  offset 
and  skip  width  as  shown  Table  3.1.  The  final  sound  characters  are  also  divided 
into  two  types  as  are  the  second  sound  vowels.  That  position  is  the  same  as  for 
the  second  sound,  but  the  sizes  are  different  with  the  second  sound,  even  though 
the  shape  of  characters  is  the  same.  The  reason  for  the  different  sizes  of  the  second 
sound  and  the  final  sound  is  that  the  composite  Hangul  letter  has  to  be  a  square 
cluster.  The  third  sound  characters  are  divided  into  two  different  types  for 
position  only,  i.e.,  the  size  of  both  characters  are  the  same.  The  size  of  these 
characters  are  slightly  smaller  than  the  first  sound,  and  the  offsets  of  both  types 
are  in  Table  3.1. 
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Figure  3.2  Sample  Font (means  "BOX"  in  English) 
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Font  for  the  Laser  printer 


The  laser  printer  fonts  are  similar  to  the  graphic  screen  fonts,  hut  the 
size  of  each  character  is  twice  as  large.  The  Lasergrafix  1200  laser  printer  has  two 
different  font  orientations.  Landscape  and  Portrait.  Consequently,  both  font 
orientations  were  developed.  Table  4.2  represents  the  sizes  and  offsets  of  the 
landscape  font  for  the  laser  printer. 


I 

1 

I 


TABLE  3.2  -  SIZE  Of  FONTS 

For  the  LASER  PRINTER 

Type  of  Character 

Bit 

Map 

X 

Offset 

Y 

Offset 

Skip 

Width 

First  Sound  Consonants 

20x16 

4 

22 

24 

Second  Sound  Typel  Vowels 

12x30 

0  j  12 

14 

Second  Sound  Type2  Vowels 

24x8 

-24 

12 

4 

12x42 

0 

0 

22 

Final  Sound  Type2  Vowels 

28x16 

-24 

2 

12 

Third  Sound  Consonants 

20x12 

-24 

-2 

10 

B.  KEYBOARD  DEVELOPMENT 

The  keyboard  is  the  main  input  to  the  computer.  The  user  gives  all  his 
directions  from  the  keyboard,  and  he  also  uses  it  to  key  in  the  documents  and  new 
text  for  insertion  and  modification. [Ref.  4:  pp.  28-39]  The  western  standard 
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keyboard  uses  the  ASCII  code.  i.e..  a  one  byte  piece  of  data.  The  Korean 
typewriter  has  two  different  consonants  i.e..  first  sound  (19  consonants)  and  third 
sound  (14  consonants),  and  two  different  vowels  i.e.,  final  sound  (14  vowels)  and 
second  sound  (14  vowels). 

The  Korean  word  processor  we  have  developed  only  has  14  fundamental 
consonants  and  5  combined  consonants  as  first  sound,  and  10  fundamental  vowels 
and  4  combined  vowels.  The  third  sound  consonants  and  other  combined  and 
compound  characters  are  generated  by  system  software  by  entering  the  character 
by  character  as  "  Pooluseuki  "  (see  Figure  1.3  Korean  letter  display).  During  the 
document  editing  process,  the  word  processor  provides  a  Korean  keyboard  display 
for  the  user.  The  position  of  Korean  keys  are  same  as  for  the  Korean  typewriter. 
Table  3.3  shows  the  conversion  of  standard  keyboard  Roman  characters  to 
Korean  characters.  The  functional  keys  of  the  word  processor  are  similar  to  those 
of  the  UNIX  editor  "  vi  "  (In  particular  control  "F"  and  "B"  for  screen 
movements,  "x". "DELETE",  and  "dd"  for  deletion,  "i"  for  insertion,  and 
"ESCVRETRX"  and  "SHIFT"  keys). 
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c:.  HANGUL  EDITING  TECHNOLOGY 


There  are  6  possible  Korean  composite  letters,  i.e..  ClVl.  ClY2.  Cl\'lY2. 
C1Y1C2,  C1Y2C2.  and  C1Y1V2C2.  as  was  discussed  above.  The  word  processor 
assigns  an  index  value  to  each  type  of  elemental  character,  which  can  be  used  to 
recognize  the  composite  character.  When  the  word  processor  user  enters  any 
character  on  the  the  keyboard,  the  system  validates  the  keystroke  and  displays 
the  correct  Korean  composite.  The  keystroke  validation  process  is  quite 
complicated. 

There  are  two  different  combinations  in  the  case  of  two  successive 
consonants,  i.e..  previous  consonant  becoming  the  elemental  third  sound  and  tb,' 
before  previous  consonant  becoming  the  compound  third  sound.  The  validation 
of  combination  depends  on  the  sum  of  the  index  values  for  each  composite  letter. 
The  system  checks  the  sum  of  the  index  value  to  determine  the  two  different 
cases.  If  it  is  30  or  35.  then  system  converts  the  last  two  characters  to  second 
and  third  sound  characters  simultaneously.  The  system  has  the  matching 
procedure  for  converting  final  sound  vowels  and  first  sound  consonants  to  second 
and  third  sound  characters.  If  the  sum  of  the  index  is  not  30  or  35.  the  system 
combines  the  last  two  consonants  into  one  third  sound  character.  This  process 
checks  for  valid  combinations. 

There  is  only  one  way  to  make  a  compound  vowel.  If  two  vowels  are  entered 
in  succession,  they  are  checked  and  then,  if  valid,  are  displayed  as  one  character 

of  the  final  sound  from  the  Korean  font.  Korean  has  only  7  valid  compound 
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vowels.  If  the  entered  character  becomes  the  third  sound,  then  this  compound 
vowel  is  changed  to  the  second  sound. 

The  word  processor  system  we  have  developed  is  similar  to  the  UNIX  "  vi  " 
editor.  This  is  because  the  active  functions  i.e..  cursor  movement,  deletion, 
insertion,  and  page  control  are  the  same  character  sequences  as  vi.  The  cursor 
movement  is  different  from  Roman  characters  since  the  skip  width  of  each  Korean 
character  is  different.  Cursor  movement  is  dependent  on  the  entered  character. 
The  system  provides  the  skip  width  of  each  character,  the  cursor  movement 
amount,  through  use  of  a  recognition  procedure  (See  Table  3.1).  The  number  of 
characters  on  one  line  is  not  fixed  because  the  Korean  letter  combination  has  6 
different  types.  The  line  length  is  controlled  by  the  available  paper  size. 

This  system  does  not  allow-  line  copy  and  line  replacement  as  in  vi.  Insertion 
can  be  done  by  input  mode  through  menu  selection  or  by  hitting  the  character  "i" 
as  in  vi.  Deletion  can  be  done  by  the  "delete"  key  during  insertion,  or  by  hitting 
the  character  "x"  or  "dd"  for  one  character  or  one  line  respectively.  Page  control 
can  be  done  by  control  "B"  or  "F"  for  screen  backward  or  forward.  More  detailed 
information  can  be  found  in  Appendix  B. 

D.  PRINTING  DOCUMENTS 

The  developed  Korean  fonts  can  be  printed  by  a  dot  matrix  printer  or  by  a 
laser  printer.  This  system  was  developed  for  a  Laser  printer  that  is  available  from 
the  IRIS  system.  The  Korean  fonts  are  loaded  to  a  Lasergrafix  1200  printer  on  a 


VAX  computer  system.  Document  printing  is  performed  by  a  simple  command 
on  the  VAX  after  the  file  has  been  transferred  from  the  IRIS  to  the  VAX. 

Font  definitions  and  other  required  addressing  information  are  stored  in  the 
Laser  printer’s  RAM  Memory  in  blocks  of  1024  bytes.  An  individual  character 
definition  can  be  stored  in  its  entirely  in  one  block  or  in  multiple  blocks.  Font 
definitions  contain  up  to  128  characters.  The  Korean  font  in  this  system  has  94 
characters  (  See  Table  3.3).  Using  the  height  and  width  in  dots  of  a  bitmap,  the 
number  of  16-bit  words  of  RAM  required  to  store  a  single  character  was  computed 
as  follows  [Ref.  5]: 

((width  +  15)  /  16)  *  height)  =  number  of  16-bit  words  required 
X umber  of  bytes  =  2  *  words 

We  designed  two  different  Korean  fonts  for  printing  Korean  documents. 
Each  font  is  downloaded  to  the  RAM  of  the  Laser  printer  as  either  a  Landscape 
or  Portrait  orientation.  One  of  the  fonts  is  the  regular  size  Korean  font,  and  the 
other  is  twice  as  big.  Appendix  C  shows  a  sample  of  a  Korean  document  using 


the  regular  size  of  font. 


IV.  RECOMMENDATION  AND  CONCLUSIONS 

The  Korean  word  processor  system  has  two  limitations.  The  first  is  that  Roman 
characters  cannot  be  included  in  the  output.  Other  interested  students  may  wish 
to  modify  the  system  to  inculde  this  feature.  Secondly,  only  1,000  lines  of  output 
are  allowed  due  to  memory  space  limitations.  However,  several  files  can  be 
created  and  concatenated  for  more  voluminous  output. 

There  are  additional  features  that  would  greatly  enhance  the  abilities  of  the 
Korean  word  processor.  The  following  additions  to  the  system  are  recommended: 

ps-  the  ability  to  edit  Korean  with  Roman  characters. 

par  the  ability  to  use  Hangul  letters  with  in  OZDRAVV  (a  system  developed 
by  Steven  J.  Firth  and  Michael  J.  Zyda. 

tor  the  ability  to  enhance  the  editor  to  be  more  like  vi  .  i.e..  text  line  copy, 
move  some  lines  of  text,  edit  text  without  insertion  mode.  etc.. 

pr  the  ability  to  print  with  special  command  as  in  VAX  TROFF  me. 

The  Korean  word  processor 'has  succeeded  in  becoming  a  popular  method  for 
Korean  students  to  edit  Hangul  documents  with  high  quality.  The  impressive 
graphic  capabilities  of  the  IRIS  series  and  Figure  processor  that  were  developed 
by  Professor  Michael  J.  Zyda,  has  enabled  Hangul  document  creation  and  editing 
to  be  carried  out  in  real  time. 
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APPENDIX  A  -  PSEUDO  CODE  OF  HANGUL  WORD 


The  following  pseudo  code  contains  the  major  parts  of  the  Hangul  word 
processor  program  on  the  IRIS  2400.  Not  covered  are  the  Korean  font  generation 
processing  and  Laser  print  usage. 


main 

{ 

title():  /*  make  object  of  title  picture  and  display  it  */ 

prefaceQ:  /*  make  object  of  screen  and  then  read  file  of 

introduction,  and  then  display  introductions  * / 
initializations:  /*  initialize  the  some  strings  for  edit  korean 

characters  and  index  for  while  loop  */ 

make  objects;  /*  make  alt  objects  i.e.,  each  information's 

boxes  contents  *  / 

font  define;  /*  korean  .title,  hangul.dis.  and 

hangul.iris  for  displaying  */ 

display  main  menu  and  explainations; 

while(TRUE) 

{ 

switch  (menuselection) 

{ 

/*  see  the  following  detail  procedure  */ 
case  CREATEFILE: 

createfileQ;  /*  enter  the  create  file  mode  * / 

/’  see  the  following  detail  procedure  */ 
case  EDITFILE: 

editfile ( ) ;  /*  enter  the  edit  file  mode  '  / 

/*  see  the  following  detail  procedure  */ 
case  HELP: 

help();  /*  make  object  and  read  help 

script  files,  and  then 

display  it  with  menu  3  *  / 

case  EXIT: 

exit  from  system: 
default: 

break; 


}  /'  end  of  switch  */ 
display  main  menu  and  explanations: 
}  /*  end  of  while  */ 

}  /*  end  of  main  program  *  / 


createfile() 

{ 


get_filename():  /* 

korean  box():  /* 

kev_dispIay(&keyboard);  /* 

initialization: 

display  main  frame  with  menul 
while(TRUE) 

{ 


get  the  file  name  */ 

make  korean  editing  box  bobject 

make  key  board  object  */ 

and  keyboard: 


if  menucontrol=FALSE  then 


get  keyboard  value; 
if  va!ue=ESC  then 

menucontrol=TRUE; 
}  /*  end  of  if..  */ 


*/ 


if  control=INPUT  then 

{ 

if  value=DELETE  then 

{ 

delete  previous  value; 
change  offset; 
change  temporary  string: 
decrease  character  pointer: 

} 

else 

if  valid  input  character  then 

{ 

put  current  value  to  temporary  string: 
increase  character  pointer: 

}  /*  end  of  if...  */ 

END  IF 


if  last  and  current  values  are  both  consonants  then 
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{ 

if  valid  combination  offset  then 

{ 

find  matching  vowel  and  consonant; 
change  the  temporarv  string; 

} 

else 

{ 

if  valid  compound  consonant  then 

{ 

find  matching  comound  consonant; 
change  the  temporav  string; 

} 

else 

display  seperatelv: 

} 

END  IF 

change  the  previous  and  before  value; 

}  /*  end  of  if..  */ 

else  if  last  and  curent  values  are  both  vowels  then 

{ 

if  valid  compound  vowel  then 

{ 

find  matching  compound  vowel: 
change  the  temporary  string: 

}  r  end  of  if...  7 
else 

display  seperately: 

END  IF 

change  the  previous  and  before  value: 

}  /*  end  of  if-else  7 

else  if  last=consonant  and  current=vowel  then 

{ 

increase  offset: 

change  the  previous  and  before  value: 

}  /*  end  of  if-else-else  */ 
else 

change  the  offset:  /*  depend  upon  situations  * / 

END  IF 

strcpy(line[index].  tempt); 

edit  object:  /*  korean  main  box  object  */ 

if  value=RETURN  or  end  of  line  then 
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{ 


edit  object: 

change  the  cursor  position: 
re  initialization: 

}  /*  end  of  if...  V 

END  IF 

if  line  pointer  meet  bottom  of  screen  then 

{ 

edit  object:  /*  get  the  new  screen  with  last 

three  line  strings  '/ 

change  skip  pointer; 

}  /*  end  of  if  ...  */ 

END  IF 

}  /*  end  of  IF  statement  */ 
else 

while(TRUE) 

{ 

switch(menuselection) 

{ 

case  INPUTMODE: 

{ 

control =IN  PUT: 
menucontrol=F  ALSE; 

} 

case  SAVE: 

savefile(filename): 
case  HELP: 
help(); 

case  RETURN : 

{ 

savefile(autosave): 

return: 

} 

case  EXIT: 

exit  from  system: 
default: 

break: 

}  /'  end  of  switch  */ 

display  main  frame  with  keyboard: 

}  /*  end  of  while  loop  */ 

END  IF 

}  /"  end  of  procedure  *  / 
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editfile() 

{ 

get  filenameQ:  /’  get  the  file  name  for  reading  a 

file  to  edit  korean  letter  '  / 

korean  box():  / *  make  object  for  main  frame  of 

korean  editing  ’  j 

key  display(&keyboard);  /*  make  key  board  displaying  object  */ 
initializations: 

display  main  box  with  informations  and  menu  2: 

while(TRUE) 

{ 

if  menucontrol=FALSE  then 

{ 

read  keyboard  device  value; 
if  value=ESC  then 

menucontrol=TRUE; 

else 

{ 

distinguish  entered  character: 
switch(value) 

{ 

case  *  *F’: 

{ 

foreward  screen: 
change  skip  pointer: 
re  initializations: 

}  /*  end  of  control  F  case  */ 
case  '  ‘  B': 

{ 

backward  screen; 
change  skip  pointer: 
reinitializations; 

}  /’  end  of  control  B  case  '  j 
case  x‘: 

if  valid  deletion  then 

{ 

delete  current  character: 
shift  one  char,  to  left: 

} 

else 

ring  the  bell; 

END  IF 
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case 'd': 

{ 

get  additional  character: 
if  value  =  ‘d'  then 
{ 

delete  one  line  string; 
shift  next  line  to  up; 

} 

else 

ring  the  bell: 

}  /’  end  of  deletion  of  line  case  */ 
case  T: 

editcontrol  =  TRUE; 

case  ’h': 

if  not  1st  column  then 

move  cursor  one  char,  to  left: 

else 

ring  the  bell: 

END  IF 

case  j’: 

if  not  bottom  of  screen  then 

move  cursor  one  line  to  down: 

else 

{ 

shift  one  line  to  up: 
display  next  line  at  bottom: 

} 

END  IF 

case  ’k‘: 

if  not  top  of  screen  then 

move  cursor  one  line  to  up: 

else 

{ 

shift  one  line  to  down: 
displav  previous  line  at  top: 

} 

END  IF 

case  T: 

if  not  end  of  line  then 

move  cursor  one  char,  to  right: 

else 

ring  the  bell: 

END  IF 
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default: 

break: 

}  /'  end  of  switch  */ 

strcpy(tempt.  line[index]); 

}  /*  end  of  IF-ELSE  statement  */ 

while(editcontrol=TRl’E) 

{ 

/*  except  the  folowing  areas: 

in  case  value=RETURN  or  meet  end  of  line 
then  string  in  right  side  of  current  cursor 
move  to  next  line.  Therefore,  following 
lines  of  scripts  are  shift  one  line  to  down  *  / 

if  value  =  ESC  then 

editcontrol  =  FALSE: 

else 

/*  almost  same  as  createfile()  procedure  */ 
insert  some  hangul: 

END  IF 

/*  almost  similiar  with  createfile()  procedure  */ 
display  main  frame  with  informations; 

}  /*  end  of  while  loop  */ 

}  /*  end  of  IF  .  i.e..  menucontrol=FALSE  case  */ 
else 
{ 

display  main  frame  with  menu  and  key  board; 
switch(menuselection) 

{ 

case  EXIT  MENU: 

{ 

sdisplay  information  instead  of  menu; 

menucontrol=FALSE; 

queue  reset; 

}  /*  end  of  exit  menu  case  */ 
case  SAVE: 

savefile(filename);  /’  save  current  contents 

case  HELP: 


/'  display  the  help  menu  '/ 


help(): 

case  RETURN: 

display  main  menu  with  explainations: 
return; 
case  EXIT: 

exit  system: 
default: 

break; 

}  /*  end  of  switch  */ 

}  j*  endofIF-ELSE  i.e..  menucontrol=TRUE  case  */ 
}  /’  end  of  w'hile  loop  i.e..  main  loop  */ 

}  /'  end  of  procedure  editfileQ  *) 
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APPENDIX  B  -  USER'S  MANUAL 


This  appendix  contains  the  Korean  Word  Processor  User's  Manual.  This 
manual  describes  the  capabilities  of  the  system,  its  usage  and  detailed  instructions 
on  its  operation.  This  appendix  is  designed  to  be  a  document  that  will  be  used  by 
people  who  wish  to  generate  Korean  documents. 
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A.  INTRODUCTION  TO  THE  SYSTEM 

The  KOREAN  WORD  PROCESSOR  system  is  designed  to  operate  on  the 
IRIS  workstation  manufactured  by  Silicon  Graphics  Inc.  This  system  was 
developed  by  Jang  Hun  Lee  in  June  1986  at  the  Naval  Postgraduate  School, 
Monterey,  California.  The  aim  of  this  system  is  to  provide  a  capability  for 
Korean  document  generation.  This  system  provides  an  interactive  editing 
capability  with  such  features  as  the  creation,  the  editing,  and  the  printing  of 
Korean  documents.  This  system  has  been  designed  so  that  the  user  can  efficiently 
operate  the  system  with  little  or  no  experience  of  Korean  typewriter  usage. 

The  system  requirements  for  the  Korean  word  processor  are: 

(1)  an  IRIS  workstation, 

(2)  the  IRIS  mouse  and  standard  keyboard. 

(3)  a  graphics  printer  capable  of  quality  graphics  production  (a  laser  printer 
is  the  preferred  printer). 

Figure  B-l  shows  the  system  features.  Figure  B-2  shows  the  system  menus. 


IRIS  SYSTEM 

1.  login 

2.  Execute  System  by  Command: 

%  korean 

3.  Display  Title  and  Preface 

4.  Select  Main  Menu  : 

CREATE  FILE  Mode  or 
EDIT  FILE  Mode 

5.  Enter  File  Name 

6.  Type  Korean  and  Save  File 

7.  Repeat  Step  4 

8.  Exit  to  System 


VAX  SYSTEM 

1 .  login 

2.  Transfer  Korean  File  from 

IRIS  to  VAX 

3.  Decide  Alignment(algn) : 

-v  :  Vertical  Paper  Usage 
-h  :  Horizontal 

4.  Execute  System  by  Command: 

%  pkorean  -algn  filename 
[-algn  filename] 

5.  Generate  Korean  by 

Laser  Printer 

6.  Exit  to  System _ 


Transfer  Korean  File 


Figure  B-l  Korean  Word  Processing  System  Feature 


MAIN  MEN! 


Exit  to  System 


CREATE  FILE 


“  Read  Filename 
“  INPUT  MODE 

-  Create  Korean  Text 
~  HELP  Script 

-  SAVE  FILE 

-  RETURN  to  MAIN 
~  Exit  to  system 


p  FORWARD 

-  BACKWARD 

-  EXIT  SCRIPT 


HELP  SCRIPT 


EDIT  FILE 


“  Read  Filename 
~  EXIT  MENU 
”  Edit  Korean  Text 
“  HELP  Script 

-  SAVE  FILE 

-  RETURN  to  MAIN 
Exit  to  system 


Figure  B-2  System  Menus  and  Functional  Structure 
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B.  USAGE  OF  SYSTEM 


The  Korean  word  processor  is  invoked  on  the  IRIS  system  by  the  command: 

korean 

Note,  no  command  line  arguments  are  needed.  This  system  allows  two 
alignments  of  the  paper,  the  Landscape  orientation  or  the  Portrait  orientation. 
This  orientation  can  be  selected  after  the  creation  of  the  document  on  the  IRIS 
system.  The  system  provides  information  about  the  next  command  selection  on 
the  sen  n  in  a  step  by  step  fashion.  The  system  also  displays  a  Korean  keyboard 
that  matches  the  standard  keyboard.  The  IRIS  Mouse  buttons  are  used  for  menu 
selection.  During  the  menu  option,  the  left  button  is  activated  for  scrolling  up, 
the  middle  button  for  selection,  and  the  right  button  for  scrolling  down  the  menu. 

Once  a  document  is  completed,  the  Korean  text  must  be  stored  in  a  file  for 
printing.  The  Korean  word  processor  does  not  print  the  Korean  directly.  The 
Korean  file  on  the  IRIS  must  be  transferred  to  the  VAX  system  upon  completion 
of  the  editing.  File  transfer  is  accomplished  via  the  ftp  program  locally. 

The  VAX  system  provides  the  ability  to  print  Korean  by  the  following 
command: 

pkorean  -alignment  filename  [-alignment  filename] 

Where  alignment  is  :  v  for  vertical  paper  (Portrait  orientation  font),  and 

h  for  horizontal  paper  (Landscape  orientation  font). 
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C.  CREATE  FILE  MODE 

This  mode  is  used  to  create  a  Korean  file  without  editing.  The  system 
requests  the  file  name  when  the  user  selects  this  mode.  The  menu  for  this  mode  is 
displayed  after  entering  the  filename,  i.e..  INPUT  MODE.  SAVE  FILE.  HELP, 
RETURN  MAIN,  and  EXIT. 

In  INPUT  MODE,  the  main  window  on  the  screen  displays  Hangul  characters 
when  the  user  hits  keys  in  accordance  with  Hangul  keyboard  that  is  displayed  on 
the  bottom  of  the  screen.  The  mouse  is  not  necessary  at  this  time.  This  system 
maps  standard  ASCII  characters  on  the  keyboard  to  the  Korean  characters 
indicated  on  the  display.  The  cursor  indicates  the  position  of  the  next  Korean 
character.  When  the  user  hits  the  return  key  or  the  cursor  meets  the  end  of  a 
line  (indicated  on  the  screen  as  vertical  red  line),  the  cursor  moves  to  the  first 
column  of  the  next  line  to  indicate  the  next  character  position.  When  the  Hangul 
text  meets  the  bottom  line,  then  the  last  3  lines  of  text  move  to  the  top  of  screen 
and  the  cursor  indicates  the  next  character  position.  If  the  user  hits  the  escape 
key  (ESC),  then  the  system  provides  a  menu  which  shows  the  user  how  to  obtain 
other  functions.  This  system  also  provides  an  autosave  file  function  when  the  user 
incorrectly  selects  the  RETURN  MAIN  or  EXIT  menu  items  without  saving  the 
file.  The  deletion  of  a  Korean  character  can  be  accomplished  only  at  the  current 
line.  If  the  user  hits  the  DELETE  key.  then  the  last  character  typed  is  deleted. 
This  deletion  removes  the  complete  Hangul  letter  in  accordance  with  the  rule  of 
combinations,  i.e.,  if  the  deleted  character  is  the  third  sound  character,  then  the 
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system  provides  one  complete  letter  without  the  third  sound  (combination 
changed  from  C1V1C2  to  C1V1). 

In  the  SAVE  FILE  option,  the  system  provides  the  capability  for  outputing 
the  Korean  text  into  a  named  file.  This  procedure  also  provides  an  autosave 
mechanism  when  the  user  exits  this  mode  without  saving  the  created  Korean  file. 

In  the  HELP  option,  the  system  has  help  scripts  that  are  useful.  This  script 
provides  detailed  information  about  system  usage.  Help  text  scrolling  is 
controlled  by  a  menu,  i.e.,  FORWARD.  BACKWARD,  and  EXIT  HELP. 

In  RETURN  MAIN,  the  system  provides  the  first  menu  for  getting  the  EDIT 
FILE  mode  or  CREATE  FILE  mode  again.  The  created  Korean  script  is  saved 
into  the  ‘autosave’  file  to  protect  the  loos  of  the  script. 

This  system  exits  when  user  selects  the  EXIT  mode  in  menu. 

D.  EDIT  FILE  MODE 

The  purpose  of  this  mode  of  the  main  menu  is  to  edit  an  existing  Korean  file. 
The  system  requests  a  filename  after  this  mode  has  been  selected.  The  menu  for 
this  mode  is  displayed  after  reading  and  displaying  the  named  Korean  file.  The 
menu  includes  five  items;  EXIT  MENU.  SAVE  FILE.  HELP.  RETURN  MAIN, 
and  EXIT. 

This  option  provides  the  settings  of  various  key  functions  at  the  bottom  of  the 
screen  when  the  user  selects  EXIT  MENU  in  this  menu.  The  usage  of  this  editing 
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system  is  similar  to  the  VAX  vi  system.  The  Korean  word  processor  allows  the 
following  keys  at  this  time: 

pa-  Y  :  the  ability  to  insert  some  Korean  text  from  the  current  cursor 
point.  The  insertion  mode  provides  the  same  ability  as  CREATE  FILE 
mode  until  the  user  hits  the  escape  key  (ESC). 

t®-  'h'  :  the  ability  to  move  the  cursor  to  the  left  one  character  position. 

The  keyboard  bell  is  rung  when  the  cursor  can  not  be  moved  further. 

j’  :  the  ability  to  move  the  cursor  to  one  line  down.  The  system 
provides  the  ability  to  shift  each  line  upward  when  the  cursor  meets  the 
bottom  of  a  line.  The  keyboard  bell  is  rung  when  the  cursor  can  not  be 
moved. 

car  ’k1  :  the  ability  to  move  the  cursor  to  one  line  up.  The  system 
provides  the  ability  to  shift  each  line  of  text  down  when  the  cursor  meets 
the  top  line  of  the  screen.  The  keyboard  bell  rings  when  the  cursor  can 
not  be  moved. 

ca-  T  :  the  ability  to  move  the  cursor  to  the  right  one  character  position. 
The  Keyboard  bell  rings  when  the  cursor  meets  the  end  of  the  line. 

tar  ‘x’  :  the  ability  to  delete  one  character  at  the  current  cursor  position. 
The  screen  immediately  displays  the  changed  Korean  text  in  that  line. 

tar  *dd’  :  the  ability  to  delete  one  line  of  Korean  text  at  the  current  cursor 
position.  The  screen  immediately  provides  the  changed  Korean  text. 

rr  ’  *F’  :  the  ability  to  scroll  forward  one  screen.  If  the  Korean  file  has 
another  page  of  script,  then  the  screen  displays  the  next  page  of  text  with 
last  2  lines  of  text  from  the  previous  page.  Otherwise  the  system  rings  the 
bell. 

tar  ’  *B’  :  the  ability  to  scroll  backward  one  screen.  If  the  Korean  file  has  a 
previous  page  of  script,  then  the  screen  is  changed  to  show  the  first  2  lines 
of  text  on  the  screen.  If  the  remaining  Korean  text  lines  are  not  enough 
to  fill  one  page  on  the  screen,  then  the  screen  displays  from  the  first  line 
of  text  at  top  of  screen.  Otherwise,  the  system  rings  the  bell. 
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The  system  returns  to  the  menu  when  the  user  hits  the  escape  key  (ESC). 
The  other  menu  items  are  similar  to  the  CREATE  FILE  mode. 

E.  USAGE  OF  THE  LASER  PRINTER 

The  Korean  word  processor  that  is  invoked  under  command,  korean  on  the 
IRIS  system,  does  not  actually  print  the  Korean  characters  produced  by  the  user. 
Instead  it  produces  a  file,  named  by  the  user,  that  can  be  printed  later  by  a  print 
utility  called  pkorean.  The  pkorean  command  is  invoked  on  the  VAX  system. 
Therefore,  the  user  must  transfer  the  created  Korean  file  to  the  VAX  system  when 
the  user  wishes  to  print  Korean. 

The  command  used  to  print  a  file  produced  by  Korean  is  the  following: 

pkorean  -alignment  filename  [-alignment  filename] 

Where  alignment  is  :  v  for  vertical  paper  usage,  and 

h  for  horizontal  paper  usage. 

Note  that  more  than  one  file  can  be  printed  in  this  manner,  as  long  as  the 
correct  number  of  alignment  values  are  placed  in  the  appropriate  places. 

For  example  to  print  the  file  'regulation1  with  a  vertical  alignment,  as  well 
as  file  "janghun'  with  a  horizontal  alignment,  the  following  command  would  be 
issued: 

pkorean  -v  regulation  -h  janghun 
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APPENDIX  C  -  SAMPLE  KOREAN  PRINTING 
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